Skip to main content

Initial Configuration

Once Pyxsoft WAF is installed, only a few steps are needed to ensure everything is running correctly. This guide explains how to validate your license, confirm the installation, and understand the initial settings that apply across all domains.

License Activation​

Pyxsoft uses a single license that covers both Pyxsoft Anti-Malware and Pyxsoft WAF (pxShield).

  • During installation, the license key is automatically validated.
  • If your license is valid, both services will remain active.
  • If there is any issue with license validation, the web interface will display an error message.
License Requirement

A valid Pyxsoft license is required for both the Anti-Malware and WAF components. Make sure your subscription is active.

Verifying Installation Success​

After installation, log in to WHM → Pyxsoft WAF.

  • If the dashboard shows incoming requests, this confirms the installation was successful.
  • From this point on, pxShield is actively filtering traffic and blocking malicious requests before they reach Apache.
Quick Check

Seeing real-time requests in the dashboard is the clearest indicator that pxShield is working correctly.

Default Configuration​

The initial configuration is automatically applied to all domains hosted on the server. This means:

  • All websites are protected by default.
  • Standard security rules are enabled without requiring manual setup.
  • Administrators can later customize rules or exceptions per domain if necessary.

The Blocked Requests View​

One of the most important tools in Pyxsoft WAF is the Blocked Requests View.

  • It allows administrators to see which attacks have been blocked.
  • Provides visibility into possible false positives, making it easier to fine-tune protection.
  • Helps confirm that the WAF is actively mitigating threats.
Why It Matters

Unlike mod_security, which provides limited visibility, Pyxsoft WAF offers clear and detailed insights into every blocked request.

Managing the pxShield Service​

The underlying service that powers Pyxsoft WAF is called pxshield.
Like any system service, it can be managed directly from the Linux console.

  • Check status

    systemctl status pxshield

  • Start the service

    systemctl start pxshield

  • Stop the service

    systemctl stop pxshield

  • Restart the service

    systemctl restart pxshield
Recommendation

Keep pxshield enabled at boot so it starts automatically with the server.

Support​

If you encounter any issues during activation or configuration:

  • Open a support ticket from your Pyxsoft customer portal.
  • Include details such as license key, server IP, and any error messages.

Our support team will help you resolve the problem quickly.